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In today's data-driven world, having an efficient and streamlined data 
analysis workflow is crucial for businesses to make informed decisions. 
With the integration of Ambee Webhooks and Google Sheets, you can 
take your data analysis capabilities to the next level. This powerful 
combination allows you to seamlessly transfer and manipulate data from 
Ambee's comprehensive environmental API directly into your Google 
Sheets, enhancing the efficiency and effectiveness of your analytical 
processes. 


Introduction to Ambee Webhooks: Enhance Your 
Data Analysis Through Google Sheets Integration 


Ambee’s Webhooks alerts provide real-time access to a vast array of 
environmental data points such as air quality index, weather conditions, 
pollen levels, and more. By integrating this valuable information with 
Google Sheets - a widely used cloud-based spreadsheet platform - you 
can easily organize and analyze the data within familiar interfaces. 


The benefits of this integration are: 


e Hassle-free data analysis: Effortlessly pull live air quality index 
readings from Ambee's API into designated columns in your Google 
Sheet and then create formulas or perform calculations on this data. 
Whether you are tracking trends over time or conducting complex 
analyses using multiple variables, this integration empowers you to 
make well-informed decisions based on up-to-date information. 
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your fingertips. This feature proves especially valuable for businesses 
that require immediate access to live information for critical decision- 
making processes. 


e Enhanced accuracy: Ambee webhooks integration with Sheets 
enhances accuracy by automating data retrieval and minimizing 
human intervention. This minimizes the risk of manual errors in 
collecting environmental information, ensuring precise and reliable 
data for various applications. 


e Saved Timed: Save time by eliminating manual data entry and the 
hassle of importing/exporting files between systems, streamlining 
data integration for increased efficiency. 


Learn more about Ambee Webhooks and its capabilities: Introducing 
Ambee Webhooks: Empowering Insights through Push-Based 
Environmental Alerts 


With seamless access to real-time environmental alerts combined with 
easy-to-use spreadsheet functionalities, you can elevate your analytical 
capabilities like never before. So why settle for manual data entry and 
outdated information when you can effortlessly enhance your data 
analysis workflow with this powerful integration? 


For this reason, here’s a step-by-step guide on how to integrate Ambee 
Webhooks with Google Sheets. 


Step-by-Step Guide to Integrating Ambee 
Webhooks with Google Sheets 


Integration of Google Sheets with the Ambee Webhooks Platform is 
quite simple. There are a total of 2 sections where the user has to 
configure details to make the integration successful. 


1. Google Sheet Section: 


e First, the user has to create a Google Account, open the Google 
Sheets, and name it something like the one shown in the image 
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write a script for the incoming webhooks data. 
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e The purpose of this script is to fetch and dump Ambee data when the 
triggering conditions are met for further processing. Below is the 
script to do the fetch and dump work: 


AppScript 


/*Post.gs Code for Webhooks*/ 
function doPost(e) { 
const lock = LockService.getScriptLock(); 
Ery I 
lock.waitLock (28000) ; 
} catch (e) { 
response = { 
Statusi Terror’; 
message: 'Request throttled' 
} 
return ContentService.createTextOutput (JSON.stringify(respo 
} 
let { parameters, postData: { contents, type } = {} } = e; 
let response = {}; 
if (type === 'text/plain' || type === 'text/html' || type === 
response = { 
status: 'error', 
message: “Unsupported data-type: ${type}~ 
} 
lock.releaseLock(); 
return ContentService.createTextOutput (JSON.stringify(respo 
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const activeSheets = activeSheetsAndNewParams.activeSheetName 


parameters = activeSheetsAndNewParams.revisedParameters; 
let keys = []; 
if (type === 'application/json' || (type === '' && contents.1 


let jsonData; 
try { 
jsonData = JSON.parse (contents); 
} catch (e) { 
response = { 
Seas. “error; 
message: 'Invalid JSON format' 
Ve 
return ContentService.createTextOutput (JSON.stringify (res 
he 
jsonData = Array.isArray(jsonData) ? jsonData.map(data => f 
keys = Array.isArray(jsonData) ? ((jsonData[0].constructor 
if (keys.length > 0) { 
activeSheets.forEach(activeSheetName => { 
let activeSheet = activeSpreadsheet.getSheetByName (acti 
let headers = activeSheet.getDataRange().offset(0, 0, 1 
if (headers.length 0 || (headers.length 1 && headers[0] 
activeSheet.appendRow (keys); 
activeSheet.setFrozenRows (1); 
if (logTimeStamp === true) { 
activeSheet.insertColumnBefore (1); 
SpreadsheetApp.flush(); 
activeSheet.getRange ("Al") .setValue ("timestamp_inco 
activeSheet.getRange ("A:A") .setNumberFormat ('dd/MM/ 
SpreadsheetApp.flush(); 


headers = activeSheet.getDataRange().offset(0, 0, 1 
t else { 
headers = keys; 


} 
let rowData = []; 
const now = new Date(); 
jsonData.forEach (rowLevelData => [rowLevelData] .map (row 
activeSheet.getRange (activeSheet.getLastRow() + 1, 1, r 
ike 
response = { 
status: 'success', 
message: 'Data logged successfully' 
We 
lock. releaseLock(); 
return ok200Status === true ? 
HtmlService.createHtmlOutput ('Data logged successfully' 
ContentService.createTextOutput (JSON.stringify (response 
tT else { 
response = { 
status: 'success', 
message: 'No parameters detected' 
hi 
lock. releaseLock(); 
return ContentService.createTextOutput (JSON.stringify (res 
} 
Ip etse { 
if (parameters) { 
keys = Object.keys (parameters); 
if (keys. length > 0) { 
logTimeStamp === true ? parameters["timestamp_incoming_ 
keys = Object.keys (parameters) ; 
const cartesianData = cartesian (parameters); 
activeSheets.forEach(activeSheetName => { 
let activeSheet = activeSpreadsheet.getSheetByName (ac 
let headers = activeSheet.getDataRange().offset(0, 0, 
if (headers.length 0 || (headers.length 1 && headers[ 
activeSheet.appendRow (keys); 
activeSheet.setFrozenRows (1); 
if (logTimeStamp === true) { 
activeSheet.moveColumns (activeSheet.getRange(1, k 
SpreadsheetApp.flush(); 
activeSheet.getRange("A:A") .setNumberFormat ('dd/M 
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i 
let rowData = []; 
cartesianData.forEach(rowLevelData => [rowLevelData]. 
activeSheet.getRange (activeSheet.getLastRow() + 1, 1, 
Me 
response = { 
status: 'success', 
message: 'Data logged successfully' 
8 
lock. releaseLock (); 
return ok200Status === true ? 
HtmlService.createHtmlOutput ('Data logged successfull 
ContentService.createTextOutput (JSON. stringify (respon 
f else { 
response = { 
status: 'success', 
message: 'No parameters detected' 
he 
lock.releaseLock(); 
return ContentService.createTextOutput (JSON.stringify(r 


function gidHandlerForPost (params, activeSpreadsheet, allSheets 
let existingSheetIds = []; 
let postDefaultSheet; 
let newParameters = {}; 
allSheets.forEach(sheet => existingSheetIds.push(sheet.getShe 
let defaultWebhookPostSheetId = documentProperties.getPropert 
let newDefaultWebhookPostSheetName = ~[POST] Webhook — ${new 
let checkDefaultOrCreateNewPostSheet = false; 
let keys = Object.keys (params) ; 
if (keys.includes('gid')) { 
const gidValues = params['gid']; 
const matchingGids = existingSheetIds.filter(sheetId => gid 
const nonMatchingGids = gidValues.filter(gid => !matchingGi 


if (matchingGids.length === 0) { 
checkDefaultOrCreateNewPostSheet = true; 
} else { 
newParameters = params; 


delete newParameters["gid"]; 
if (nonMatchingGids.length > 0) { 
newParameters["gid"] = nonMatchingGids; 
} 
if (matchingGids.length === 1) { 
postDefaultSheet = allSheets.filter(sheet => sheet.getS 
return { 
activeSheetNames: [postDefaultSheet[0].getSheetName () 
revisedParameters: newParameters, 
Ie 
p else { 
let validSheetNames = []; 
matchingGids.forEach(gid => { 
postDefaultSheet = allSheets.filter(sheet => sheet.ge 
if (postDefaultSheet.length !== 0) { 
validSheetNames.push (postDefaultSheet [0] .getSheetNa 
i 
be 
return { 
activeSheetNames: validSheetNames, 


revisedParameters: newParameters, 


} 
} else { 
checkDefaultOrCreateNewPostSheet = true; 
} 
if (checkDefaultOrCreateNewPostSheet) { 
if (!defaultWebhookPostSheetId) { 
defaultWebhookPostSheetId = activeSpreadsheet.insertSheet 
documentProperties.setProperty ('defaultWebhookPostSheetId 
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g 


f else { 
postDefaultSheet = allSheets.filter (sheet => sheet.getShe 
if (postDefaultSheet.length !== 0) { 
return- { 


activeSheetNames: [postDefaultSheet[0].getSheetName () 
revisedParameters: params, 
he 
} else { 
defaultWebhookPostSheetId = activeSpreadsheet.insertShe 
documentProperties.setProperty ('defaultWebhookPostSheet 
return {| 
activeSheetNames: [newDefaultWebhookPostSheetName], 


revisedParameters: params, 


he 
} 
} 
} 
} 
const flatten = (obj, prefix = '', res = {}) => 
Object.entries(obj).reduce((r, [key, val]) => { 
const k = “S{prefix}${key}*; 
if (typeof val === 'object' && val !== null) { 
Glatten(vall,) Sik} Ti? 
} else { 
res[k] = val; 
} 


return r; 


We res)? 


e The next step is to simply copy and paste the code above to the 
Appscript editor and then save it. 


e Once it’s saved, the next step is to deploy the app on the server, for 
which the steps are given through the images below. 


Ñ Apps Script Webhooks © 
o fis + 6 fa] Execution log New deployment 
lock .waitLock(28800) 
<> © Codegs } catch (e) { Manage deployments 
response = { 
9 Libraries + status: 'error Test deployments 


message: ‘Request throttled 


@ Services + ) 
return ContentService, createTextOutput (JSON. stringify( response) ) .setMimeType(ContentService.MimeType. JSON) ; 
let { parameters, postData: { contents, type } = {) } =e; 
8 let response = {} 
if (type === ‘text/plain’ || type === ‘text/html’ || type === ‘application/xml’) { 
response = { 


status: ‘error’, 
message: “Unsupported data-type: ${type) 

} 

lock .releaseLock() 

return ContentService,createTextOutput(JSON.stringify(response)) .setMimeType(ContentService.MimeType , JSON) 


activeSpreadsheet = Spreadsheetapp.getActíveSpreadsheet ( 
st allSheets = activeSpreadsheet .getSheets(); 


const activeSheetsAndNewParams = gidHandlerForPost(parameters, activeSpreadsheet, allsheets) ; 
canst activeSheets = activeSheetsAndNewParams.activeSheetNames 
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Test Webhooks 


Web app 


[ more 


This can also be used as a library. Leam more 


New deployment 


The Web App requires you to authorize access to your data, 


Cancel 


New deployment 
Deployment successfully updated 


Version 1 on Sep 7, 5:07PM 


Deployment 10 


D Copy 


Web app 


e Once the Web App is published, the user has to copy the URL 
provided under the Web App section. 


Ambee Webhooks Section 


To set up an Ambee Webhooks account, simply select Webhooks from 
under the Product Tab on the Ambee website: 
https://www.getambee.com/. 


Products 
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Ambee Webhooks: 
Your Gateway To 
Instant Climate Insights 
And Alerts 


ebh 


solution 


Ambee Webhooks is an invite-only platform. 


e Once you get access to the platform, your home screen will look 
something like this: 


Name Data Type Created at 


weather 31st Aug’23 | 03:55 PM 


AQ alent2 a 31st Aug’23 | 03:43 PM 


e Click on the Add Integration button in the top right corner, and you 
will get an option to set up the alerts. 


e Here, you can enter details like Alert Name, Data Type, Locations, 
and Conditions to trigger the alerts. 
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e Now, you have to enter the URL you copied from Google Sheets. 
Then, save all the details and go to the last step shown below 


e You must now enter the frequency and time range as per your 
requirements and click Submit. 


e Now you are all set to receive the alerts as per your setup triggering 
condition. 


e “ Fi 
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Your alert has been successfully added! 


e To visualize the data on Google Sheets, you have to wait for an hour. 
If your frequency is set to hourly, the data on your sheet will look like 
this: 
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e Similarly, you can set up alerts for your desired data sets, such as 
weather, pollen, or air quality, by providing various triggering 
conditions. 


Use Cases For Ambee Webhooks'’ Integration with 
Google Sheets 


Accurate Data Analysis 


Use webhooks to receive real-time environmental data updates from 
Ambee's API. Analyze the data to track trends, identify patterns, and 
gain insights into changing environmental conditions. 


Environmental Data Integration 


Integrate Ambee's environmental data into your existing systems or 
applications using webhooks. For example, integrate air quality data into 
a weather app or smart home automation system to provide users with 
comprehensive environmental information. 


Timely Triggered Campaigns 


Integrate Ambee Webhooks with Google Sheets for campaign 
management. Marketers can trigger their campaigns based on specific 
environmental conditions. For instance, when certain thresholds are 
met, webhooks can instantly update the Google Sheet, prompting the 
launch of a tailored marketing campaign. This ensures campaigns are 
timely, data-driven, and highly responsive to evolving trends and 
customer interactions. 
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purposes without manual intervention. 


Real-Time Insights 


Receive real-time environmental data updates through webhooks to 
provide users with up-to-the-minute information. For instance, alert 
users about sudden changes in air quality or weather conditions that 
may affect their plans or health. 


Collaborative Data Sharing 


Share environmental data with collaborators, partners, or customers 
using webhooks. Collaborate on research projects, environmental 
monitoring, or data-driven decision-making by providing access to real- 
time data. 


Unlock the Power of Data Analysis with Ambee 
Webhooks and Google Sheets Integration 


Webhooks and Google Sheets integration empower users with 
efficient data analysis. It seamlessly collects real-time environmental 
data, like air quality and weather conditions, and transfers it to 
organized spreadsheets via webhooks. This integration facilitates easy 
visualization, charting, and analysis, enabling valuable insights into 
trends and correlations. 


Whether for personal monitoring or business optimization, this solution 
streamlines data-driven decision-making. Embrace the power of data 
analysis through Ambee Webhooks and Google Sheets integration 
today and make informed choices that impact health or operations 
positively. Start integrating now for a more informed perspective on 
your environment or to enhance efficiency. 


Liked what you just read? Share it with a friend. Q Q Q (<) 


Have questions? Ee 


Get in touch! Enter your Email ID 
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